home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / pure_src / t.src < prev    next >
Encoding:
Text File  |  1992-08-04  |  1.2 KB  |  40 lines
  1. screen(capsensitive("Talarm"))
  2. NAME
  3.     Talarm - schedule an alarm to occur
  4.  
  5. SYNOPSIS
  6.     LONG Talarm(LONG time);
  7.  
  8. DESCRIPTION
  9.     If time is greater than 0, schedule a SIGALRM signal to be
  10.     delivered to the process that many seconds from now. Note 
  11.     that unless a handler for SIGALRM has been established by 
  12.     means of the \#Psignal\# function, then the signal will kill the 
  13.     process.
  14.  
  15.     If time == 0, then any previously scheduled alarm is can-
  16.     celled.
  17.  
  18.     If time is negative, then no change is made to what alarms 
  19.     are scheduled; in this case, only the returned value (the 
  20.     number of seconds left before any alarm) is of interest.
  21.  
  22. RETURNS
  23.     If an alarm had been scheduled before this call to Talarm,
  24.     return the number of seconds remaining until that previously 
  25.     scheduled alarm.
  26.  
  27.     Otherwise, return 0.
  28.  
  29. SEE ALSO
  30.     \#Pause\#, \#Psignal\#
  31.  
  32. BUGS
  33.     Internal calculations are done in milliseconds, not seconds, 
  34.     so the returned value is not exactly accurate.
  35.  
  36.     For the same reason, setting an alarm more than 2 million
  37.     seconds or so into the future will not work correctly.
  38.     
  39. Last change: Oct. 1, 1991\end
  40.